/*
 * Fichier: HTMLBuilder.java
 * Crée le: 10 novembre 2007.
 * Modifié: 14 février 2009.
 * Auteurs: Sébastien ESTIENNE.
 * SiteWeb: http://www.prog-info.org/
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

package javaexos.tools;

/**
 * <p>Classe fournissant des constantes HTML.</p>
 * @author Sébastien ESTIENNE.
 */
public final class HTMLBuilder
{
   /** Caractère d'ouverture de balise. */
   private static final char OPEN = '<';

   /** Caractère de fermeture de balise. */
   private static final char CLOSE = '>';
   
   /** Caractère slash. */
   private static final char SLASH = '/';
   
   /** Caractère d'espacement. */
   private static final char SPACE = ' ';
   
   /** Caractère égal. */
   private static final char EQUAL = '=';
   
   /** Carctère de guillemet. */
   private static final char QUOTE = '"';
   
   /**
    * <p>Construction d'une balise ouvrante simple.</p>
    * @param tag Le marqueur.
    * @return Retourne la balise.
    */
   public static String buildOpenMarker(String tag)
   {
      return buildOpenMarker(tag, false);
   }
   
   /**
    * <p>Construction d'une balise ouvrante simple.</p>
    * @param tag Le marqueur.
    * @param closed Indique si la balise est ouvrante et fermante.
    * @return Retourne la balise.
    */
   public static String buildOpenMarker(String tag, boolean closed)
   {
      StringBuilder result = new StringBuilder();
      
      result.append(OPEN);
      result.append(tag);
      if(closed)
      {
         result.append(SPACE);
         result.append(SLASH);
      }
      result.append(CLOSE);
      
      return result.toString();
   }
   
   /**
    * <p>Construction d'une balise avec attributs et valeurs.</p>
    * @param tag Le marqueur.
    * @param attributes Les attributs associés à la balise.
    * @param values Les valeurs des attributs.
    * @return Retourne la balise.
    */
   public static String buildOpenMarker(String tag, String[] attributes, String[] values)
   {
      return buildOpenMarker(tag, attributes, values, false);
   }
   
   /**
    * <p>Construction d'une balise avec attributs et valeurs.</p>
    * @param tag Le marqueur.
    * @param attributes Les attributs associés à la balise.
    * @param values Les valeurs des attributs.
    * @param closed Indique si la balise est ouvrante et fermante.
    * @return Retourne la balise.
    */
   public static String buildOpenMarker(String tag, String[] attributes, String[] values, 
         boolean closed)
   {
      if(attributes.length != values.length)
      {
         return buildOpenMarker(tag);
      }
      
      StringBuilder result = new StringBuilder();
      
      result.append(OPEN);
      result.append(tag);
      for(int i = 0; i < attributes.length; i++)
      {
         result.append(SPACE);
         result.append(attributes[i]);
         result.append(EQUAL);
         result.append(QUOTE);
         result.append(values[i]);
         result.append(QUOTE);
      }
      if(closed)
      {
         result.append(SPACE);
         result.append(SLASH);
      }
      result.append(CLOSE);
      
      return result.toString();
   }
   
   /**
    * <p>Construction d'une balise fermante.</p>
    * @param tag Le marqueur.
    * @return Retourne la balise.
    */
   public static String buildCloseMarker(String tag)
   {
      StringBuilder result = new StringBuilder();
      
      result.append(OPEN);
      result.append(SLASH);
      result.append(tag);
      result.append(CLOSE);
      
      return result.toString();
   }
}
